CallMarkProc

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODSemanticInterface

CallMarkProc
The CallMarkProc method marks a large series of objects using the specified mark token.
void CallMarkProc (in ODPart thePart,
                   in ODOSLToken dToken,
                   in ODOSLToken markToken, 
                   in ODSLong index);
thePart
A reference to the part associated with this semantic interface object.
dToken
A reference to the OpenDoc token that identifies the object to be marked.
markToken
A reference to an OpenDoc token to be used for marking the elements.
index
The current mark count. This method should associate this index with each marked element.

DISCUSSION
OpenDoc calls this method once for each object that must be marked. Your override of this method should mark the object specified by the dToken parameter using the specified mark token and index. OpenDoc uses the index values to identify a range of objects to unmark when it calls the CallAdjustMarksProc method.
Before OpenDoc can call this method, you must call your semantic interface object's SetOSlSupportFlags method and specify the flag kAEIDoMarking to indicate that your semantic interface supports marking. In general, your part should override the CallGetMarkTokenProc, CallMarkProc, and CallAdjustMarksProc methods in the following cases: it already supports the marking of objects or it expects to deal with large numbers of records that might not all fit into memory at once.

EXCEPTIONS
The Apple Event Manager may throw an exception if this method is unable to mark the specified object.
This method may throw platform-specific exceptions.

SEE ALSO
The ODSemanticInterface::CallAdjustMarksProc method (page 584).
The ODSemanticInterface::CallGetMarkTokenProc method (page 592).
The ODSemanticInterface::SetOSLSupportFlags method (page 599).
The ODOSLToken class (page 456).